«DESTPT»: optional, the upper left corner of the drawing. Default value is 0,0.
«ICNSTATE»: optional, a number specifying the state of the ICN. Possible value are:
1: non-open,non-selected, online
2: non-open,selected, online
3: non-open,non-selected, offline
4: non-open,selected, offline
5: open,non-selected, online/offline
6: open,selected, online/offline
Because HyperCard uses so many screen buffers, we can not draw directly to HC's grafPort since our image would probably be erased very quickly. Thus we convert the ICN into a Picture, copy it to the clipboard, and then paste it onto the card. This causes whatever was in the clipboard before calling the XCMD to be lost.
BEWARE: This XCMD uses the invisible desktop file to retrieve the icons it needs. While there is nothing inherently dangerous in doing this, things will change with System 7.0. The Desktop Manager (currently used by Appleshare file servers) does not use a desktop file and so you will probably get generic icons whenever you call this XCMD and Desktop Manager is running.
COMING SOON: A desktop manager compatible version!